package com.example.forum.dao;

import com.example.forum.model.User;
import org.apache.ibatis.annotations.Mapper;
import org.apache.ibatis.annotations.Param;

import java.util.List;

@Mapper
public interface UserMapper {
    int deleteByPrimaryKey(Long id);

    int insert(User record);

    int insertSelective(User record);

    User selectByPrimaryKey(Long id);

    int updateByPrimaryKeySelective(User record);

    int updateByPrimaryKey(User record);

    /**
     * 根据用户名查询用户信息
     * @param username 用户名
     * @return 查询到的用户对象
     */
    User selectByUsername(String username);
    
    /**
     * 查询所有未删除的用户
     * @return 用户列表
     */
    List<User> selectAllUsers();
    
    /**
     * 统计总用户数（未删除的）
     * @return 用户总数
     */
    int countTotalUsers();
    
    /**
     * 统计今日新增用户数
     * @return 今日新增用户数
     */
    int countTodayNewUsers();
    
    /**
     * 获取活跃用户列表，按文章数量排序
     * @param limit 限制返回的用户数量
     * @return 活跃用户列表
     */
    List<User> selectActiveUsers(@Param("limit") int limit);
    
    /**
     * 分页查询用户列表
     * @param offset 偏移量
     * @param limit 每页数量
     * @param sort 排序字段
     * @param order 排序方向
     * @return 分页用户列表
     */
    List<User> selectUsersByPage(@Param("offset") int offset, 
                                @Param("limit") int limit, 
                                @Param("sort") String sort, 
                                @Param("order") String order);
    
    /**
     * 根据条件查询用户总数
     * @return 用户总数
     */
    int countUsersByCondition();
}